home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 005a / toybox11.zip / TOYBOX.DOC < prev    next >
Text File  |  1991-10-21  |  22KB  |  474 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                               ToyBox 1.1
  11.  
  12.                              User's Guide
  13.  
  14.               Copyright (c) 1991 Virtual Magic Software
  15.                           All Rights Reserved
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                  Section 1:   What is ToyBox?
  24.                  Section 2:   System Requirements
  25.                  Section 3:   Registration Information
  26.                  Section 4:   Fast Start
  27.                  Section 5:   Installing ToyBox
  28.                  Section 6:   Starting ToyBox
  29.                  Section 7:   Getting Around in ToyBox
  30.                  Section 8:   The Main ToyBox Window
  31.                  Section 9:   Using the Helper Window
  32.                  Section 10:  Adding Programs to ToyBox
  33.                  Section 11:  Removing Programs from ToyBox
  34.                  Section 12:  Viewing or Modifying Program Information
  35.                  Section 13:  Dos Prompt
  36.                  Section 14:  Disabling the STOP Button
  37.                  Section 15:  Turning Sound On/Off
  38.                  Section 16:  Error Messages
  39.                  Section 17:  License and Warranty
  40.                  Section 18:  Icon List
  41.  
  42.  
  43.  
  44. 1.  What is ToyBox?
  45.  
  46. ToyBox is a state-of-the-art graphical interface designed specifically 
  47. for children, ages 3 and up.  ToyBox displays large, three-dimensional 
  48. buttons, with brightly-colored icons, which act as a graphical menu of 
  49. your children's favorite programs.  Children can select any of their 
  50. programs with a single keystroke or click of the mouse.  They no longer 
  51. need your help each time they want to start a new program.  When they 
  52. finish one program, ToyBox automatically takes over and redisplays the 
  53. program buttons, allowing them to select another program.  Up to twenty 
  54. program buttons can be displayed on a VGA monitor, sixteen on an EGA.
  55.  
  56. It is incredibly easy for you, the helper, to add programs to ToyBox or 
  57. to remove them, but children cannot access this information.  To add a 
  58. program, simply type in a title for the program button, the program's 
  59. location on disk, and the name of the icon you want on the program 
  60. button.  Choose from a collection of 72 colorful, educational icons 
  61. which are included on the ToyBox disk.  ToyBox also protects the rest of 
  62. your system from inquisitive young minds by letting you set options 
  63. which prevent children from exiting the ToyBox environment.
  64.  
  65. In addition to running your children's favorite existing programs today, 
  66. the ToyBox interface, with its advanced graphics, will be used for a 
  67. series of children's learning programs which we at Virtual Magic are 
  68. currently developing.
  69.  
  70. Although ToyBox is designed "just for kids," it's so easy and so much 
  71. fun to use you may be tempted to use it for your own "serious" programs.  
  72. Go for it!  ToyBox will handle Lotus 1-2-3 and WordPerfect as well as it 
  73. handles Mickey Mouse and Sesame Street.
  74.  
  75.  
  76. 2.  System Requirements:
  77.  
  78.     MS-DOS
  79.     512k memory.  (Uses only 19k while another program is running.)
  80.     EGA or VGA graphics.
  81.     Hard disk recommended.
  82.     Microsoft compatible mouse optional.
  83.  
  84.  
  85. 3.  Registration Information
  86.  
  87. We are distributing ToyBox as shareware, which means we allow you to try 
  88. the program out before you pay for it.  We also encourage you to 
  89. distribute the program (unaltered) to friends, bulletin board systems, 
  90. etc.  However, if you like the program and continue to use it, please 
  91. send a $15.00 registration fee to:
  92.  
  93.     Virtual Magic Software
  94.     P.O. Box 615
  95.     Fort Monmouth, NJ 07703
  96.  
  97. When you send your registration fee, we'll send you a disk containing 
  98. the latest registered version of ToyBox, which doesn't show the opening 
  99. advertisement.  We'll also include on the disk a utility for designing 
  100. your own ToyBox icons.  Please specify whether you would like a 3.5" or 
  101. 5.25" disk.    
  102.  
  103. If you have any questions or comments about ToyBox, please send them to 
  104. the above address.  You can also contact us on CompuServe (70304,2045)
  105. or Prodigy (CJKH33A).  It is through your comments and suggestions that 
  106. we can make ToyBox and future products even better.   
  107.  
  108.  
  109. 4.  Fast Start
  110.  
  111. We recommend you read through this User's Guide to learn exactly what 
  112. ToyBox can do; however, for those of you who would rather explore on 
  113. your own, here are four quick pieces of information to get you started:
  114.  
  115.     1)  [Alt]-[h] lets you (the helper) open the Helper Window to add, 
  116. remove or modify program information.
  117.  
  118.     2)  Example program information (Add Program Window):
  119.  
  120.         Title:  Dinosaur Game
  121.         Program:  C:\CHILDREN\GAMES\DINOSAUR
  122.         Command Line Arguments:  (normally none)
  123.         Icon:  LBD
  124.  
  125.     3)  Available icons are listed in Section 18 of this User's Guide 
  126. or, for quick reference, in a separate file named ICONLIST.DOC.
  127.  
  128.     4)  [Alt]-[s] lets you (the helper) exit ToyBox even if the STOP 
  129. Button is disabled.
  130.  
  131.  
  132. 5.  Installing ToyBox
  133.  
  134. We normally distribute the unregistered version of ToyBox as a single 
  135. compressed file named TOYBOX11.ZIP.  You must "unzip" this file into 
  136. separate files using the shareware program PKUNZIP (trademark of PKWARE, 
  137. Inc.).  We suggest unzipping the file into an empty directory on your 
  138. hard drive, so the ToyBox files will not get mixed in with other files 
  139. in the directory.  When PKUNZIP finishes, the directory will contain the 
  140. following files:  TOYBOX.EXE, TOY2.OVL, TOY3.OVL, INFO.TBI, OK.TBI, 
  141. STOP.TBI, TOYBOX.WIN, READFAST.DOC, TOYBOX.DOC, ICONLIST.DOC, UPDATE.DOC 
  142. and 72 icon files (*.ICN).  If you desire you can move TOYBOX.WIN, the 
  143. *.DOC files, and unused *.ICN files to another directory, but you must 
  144. leave the remainder of the files together in one directory.  After 
  145. you've run ToyBox for the first time, you will notice that it has 
  146. created two more files (TOYBOX.INF and TOYFILE.TMP).  Do not move or 
  147. remove TOYBOX.INF or you will lose all the information about the 
  148. programs you've installed in ToyBox.  If you install ToyBox on a floppy 
  149. disk, don't write-protect the disk.  Also, be aware that ToyBox will run 
  150. much slower from a floppy disk than from a hard disk.
  151.  
  152.  
  153. 6.  Starting ToyBox
  154.  
  155.     a.  From DOS:  First change to the directory containing the ToyBox 
  156. files (or ensure this directory is in the PATH statement in your 
  157. AUTOEXEC.BAT file), then type TOYBOX.  ToyBox automatically detects 
  158. whether your system has an EGA or VGA compatible graphics card and 
  159. switches to the highest graphics mode available.  It will also detect 
  160. the presence of a mouse if you have installed a mouse driver such as 
  161. MOUSE.COM in your AUTOEXEC.BAT file, or MOUSE.SYS in your CONFIG.SYS 
  162. file.  If you have display problems, such as part of the main ToyBox 
  163. Window not being on the screen, or the mouse pointer not being visible, 
  164. you can force ToyBox into the correct graphics mode by typing TOYBOX EGA 
  165. or TOYBOX VGA.  If the mouse pointer still does not display, check to 
  166. ensure you have a mouse driver properly installed.
  167.  
  168.     b.  From Microsoft Windows:  We've included a special ToyBox 
  169. icon for Microsoft Windows named TOYBOX.WIN.  Follow instructions 
  170. included in the Microsoft Windows Users Guide to install and run 
  171. ToyBox as a DOS application under Windows.  
  172.  
  173.  
  174. 7.  Getting around in ToyBox
  175.  
  176. When you open a new window, such as the Helper Window described below, 
  177. it pops up on top of the current window and becomes the new active 
  178. window.  You can only access objects (normally buttons or boxes) that 
  179. are in the active window.  These objects may be accessed by keyboard or 
  180. mouse.  
  181.  
  182.     a.  Selecting Objects (Keyboard):  Move the cursor (a red square 
  183. outline, except in text boxes) to the desired object by pressing the 
  184. arrow keys, then press the [Enter] key.
  185.  
  186.     b.  Selecting Objects (Mouse):  Move the mouse pointer to the 
  187. desired object and click any of the mouse buttons.  To make it easier 
  188. for small children, all mouse buttons have the same effect.
  189.   
  190.  
  191.     c.  Closing the Active Window (Keyboard):  Press the [Esc] key, or 
  192. move the cursor to the button in the upper left corner of the window and 
  193. press the [Enter] key.  The button will either be a large red STOP 
  194. button if the window is one that can be accessed by the child, or a 
  195. smaller red button if the window is designed only for the adult helper.
  196.  
  197.     d.  Closing the Active Window (Mouse):  Move the mouse pointer to 
  198. the red button in the upper left corner of the window and press the 
  199. [Enter] key.
  200.  
  201.     e.  Editing Text:  To add programs to ToyBox, you (the helper) 
  202. must type certain program information such as program title, file name, 
  203. etc., into text boxes.  This section describes the procedures for 
  204. entering and editing text.
  205.  
  206.         1)  Positioning the Text Cursor (Keyboard):  Move the text 
  207. cursor (a thin, black vertical line) to the desired text box.  Move to 
  208. the desired location within the text box by using the Left-Arrow or 
  209. Right-Arrow.  Pressing the [Enter] key will move the cursor out of the 
  210. text box to the next object.
  211.  
  212.         2)  Positioning the Text Cursor (Mouse):  Move the mouse 
  213. pointer directly to the desired location within any of the text boxes in 
  214. the active window and click one of the mouse buttons.
  215.  
  216.         3)  Entering Text:  After positioning the cursor, begin 
  217. typing.  The text will be inserted at the cursor location.  ToyBox will 
  218. not allow you to enter more text than will fit inside the text box.
  219.  
  220.         4)  Deleting Text:  To delete a character to the right of 
  221. the current cursor location, press the [Delete] key.  To delete a 
  222. character to the left of the cursor, press the [Backspace] key.    
  223.  
  224.  
  225. 8.  The Main ToyBox Window
  226.  
  227. From the main ToyBox Window, the child can run a program simply by 
  228. moving the red square cursor with the arrow keys to any of the program 
  229. buttons that you have installed, then pressing the [Enter] key, or by 
  230. moving the mouse pointer to one of the program buttons and clicking any 
  231. of the mouse buttons.  Programs are installed by using the Helper Window 
  232. as described below.  The child can also access the the STOP Button to 
  233. leave ToyBox, which you can disable, and the Information Button, which 
  234. children seem to enjoy playing with.  
  235.  
  236.  
  237. 9.  Using the Helper Window
  238.  
  239. The Helper Window is where you add, remove or modify program information 
  240. in ToyBox.  This window is designed to be inaccessible to the child.  
  241. The only way to access the Helper Window is by pressing [Alt]-[h] (hold 
  242. down one of the [Alt] keys and press the [h] key).  It is best not to 
  243. allow the child to see you perform this operation.  Children are very 
  244. quick to pick up seemingly complicated tasks.  When you have finished 
  245. making changes, close the Helper Window and the changes will be 
  246. reflected in the main ToyBox Window, ready for the child to use.
  247.     
  248.  
  249. 10.  Adding Programs to ToyBox
  250.  
  251. From the Helper Window, select the 'Add a Program to ToyBox' button.  
  252. This will open up the Add Program Window.
  253.  
  254.     a.  Title:  Type the name you want associated with the program 
  255. button.  This name will appear under the program button on the screen.  
  256. Any name up to 17 characters is valid.
  257.  
  258.     b.  Program:  ToyBox needs to know where to find your program, 
  259. including the complete drive, directory and filename.  For example if 
  260. the program you want to add is 'DINOSAUR.EXE' and it is on drive 'C:' in 
  261. the '\PROGRAMS\JIMMY' directory, the complete path would be:
  262.  
  263.             C:\PROGRAMS\JIMMY\DINOSAUR.EXE
  264.  
  265. It is safest to type in this complete path, in case you later move your 
  266. ToyBox files to another drive or directory.  However, to save you some 
  267. typing, ToyBox does provide the following defaults for some of the 
  268. information:
  269.  
  270.         1)  If you do not specify a drive or directory (e.g. you 
  271. type only 'DINOSAUR.EXE'), ToyBox will look first in the current 
  272. directory (the directory containing TOYBOX.EXE) .  If it does not find 
  273. 'DINOSAUR.EXE' in the current directory, it will then begin searching 
  274. all directories listed in the PATH statement in the AUTOEXEC.BAT file.  
  275. If it cannot not find the program in any of these directories, it will 
  276. return an error message when you attempt to run the program.
  277.  
  278.         2)  If you specify a drive but no directory (e.g. 
  279. 'B:DINOSAUR.EXE'), ToyBox will default to the root directory on the 
  280. specified drive.  Typing 'B:DINOSAUR.EXE' is equivalent to typing 
  281. 'B:\DINOSAUR.EXE'.
  282.  
  283.         3)  If you specify a directory but no drive (e.g. 
  284. '\PROGRAMS\JIMMY\DINOSAUR.EXE'), ToyBox will default to the specified 
  285. directory on the current drive (the drive containing TOYBOX.EXE).
  286.  
  287.         4)  If you don't specify an extension to the filename (e.g.  
  288. 'B:\PROGRAMS\JIMMY\DINOSAUR'), ToyBox will look in the specified or 
  289. default drive and directory for the filename as given (with no 
  290. extension).  If the file is not found, ToyBox adds '.COM' and searches 
  291. again.  If that search is not successful, ToyBox adds '.EXE' and 
  292. searches again.  If the search is still not successful, ToyBox will add 
  293. '.BAT' and try one last time.  In the above example ToyBox will look in 
  294. the specified or default directories for a file named 'DINOSAUR' with no 
  295. extension.  If that search is unsuccessful it will look for a file named 
  296. 'DINOSAUR.COM'.  If it still has no success it will look for a file 
  297. named 'DINOSAUR.EXE'.  Finally, it will look for a file named 
  298. 'DINOSAUR.BAT'.
  299.  
  300.     c.  Command Line Arguments:  Some programs allow or require 
  301. arguments (also called switches) to be typed in after the program 
  302. filename to pass information to the program or to set various 
  303. parameters.  Type these arguments just as you would following the 
  304. filename at the DOS command line.
  305.  
  306.     d.  Icon:  ToyBox provides a number of colorful icons to 
  307. distinguish each program button.  These icons allow the child to 
  308. associate the various programs in ToyBox with letters, numbers, colors 
  309. and shapes instead of words.  A complete listing of the icons included 
  310. with ToyBox is contained at the end of this User's Guide.  For quick 
  311. reference, the icon listing is also included on disk as a separate file 
  312. named ICONLIST.DOC.  If the icon files are located in the same directory 
  313. as TOYBOX.EXE, you only need to type in the filename itself, without the 
  314. .ICN extension. For example, if you wanted to use LBD.ICN, which is a 
  315. light blue diamond icon, you would type LBD in the Icon text box.  If 
  316. the icon files are located on another drive or directory, you must type 
  317. the path and filename (e.g. 'C:\TOYBOX\ICONS\LBD').  If you don't give 
  318. an icon filename, or you give an invalid filename, ToyBox will display a 
  319. grey button with no design.
  320.  
  321.     e.  Saving the Information:  After you have entered all the 
  322. necessary information, you can save it by selecting the large 'OK' 
  323. button.  This will save the information to disk, close the Add Program 
  324. Window, and bring you back to the Helper Window.  If you wish to leave 
  325. the Add Program Window without saving the information you have just 
  326. typed, simply select the red button in the upper left corner of the 
  327. window.        
  328.  
  329.  
  330. 11.  Removing Programs from ToyBox
  331.  
  332. From the Helper Window, select the 'Remove a Program from ToyBox' 
  333. button.  This will open up the Remove Program Window.  This window will 
  334. display the titles of all programs currently in ToyBox.  To mark a 
  335. program for removal, select it with the keyboard or mouse.  The box 
  336. containing the title will change to black.  You can mark as many 
  337. programs for removal as you wish.  If you incorrectly mark a program for 
  338. removal or decide you don't want to remove a program, simply select the 
  339. title again and the box will return to grey.  After you have marked all 
  340. desired programs for removal, press the large 'OK' button to actually 
  341. remove the programs.  To leave the Remove Program Window without 
  342. removing any programs (even if they are marked for removal) simply 
  343. select the red button in the upper left corner of the window.  (NOTE:  
  344. Removing a program from ToyBox in no way affects the program itself.  
  345. The program still resides on the disk and you can access it normally 
  346. from the DOS command line.  It can also be added back later to ToyBox if 
  347. you desire.)  
  348.  
  349.  
  350. 12.  Viewing or Modifying Program Information
  351.  
  352. From the Helper Window, select the 'View/Modify Program Info' button.  
  353. This will open up the View/Modify Window.  This window will display the 
  354. titles of all programs currently in ToyBox.  Select the title of the 
  355. program you wish to view or change.  Selecting a title will open the 
  356. View/Modify Program Window which contains all the program information 
  357. (title, path, arguments, icon file) for that particular program.  You 
  358. can change the information using the same editing methods you used when 
  359. you originally added the information to ToyBox.  After you have made all 
  360. desired changes, press the large 'OK' button to save the changes to 
  361. disk.  To leave the View/Modify Program Window without saving the 
  362. changes you just entered, select the red button in the upper left corner 
  363. of the window.
  364.  
  365.  
  366. 13.  DOS Prompt
  367.  
  368. You can temporarily leave ToyBox and go to the DOS prompt by selecting 
  369. the 'DOS Prompt' button from the Helper Window.  This will allow you to 
  370. perform any operation you normally perform from DOS.  This feature is 
  371. useful, for example, if you want to double-check the directory path of a 
  372. program you are attempting to add to ToyBox, or if you need take a quick 
  373. on-line look at this user guide.  When you are ready to return to 
  374. ToyBox, type 'EXIT'.  (Do not type 'TOYBOX'.  This will cause a second 
  375. copy of ToyBox to be run on top of the first copy, using up excessive 
  376. memory, and possibly causing the program to crash at some later point.  
  377. If you do type TOYBOX by mistake, simply stop ToyBox and, at the DOS 
  378. prompt, type EXIT.  This will bring back the original ToyBox.)
  379.  
  380.  
  381. 14.  Disabling the STOP Button
  382.  
  383. You can prevent the child from leaving the ToyBox environment by 
  384. disabling the STOP Button on the main ToyBox Window.  Do this by 
  385. selecting 'STOP Button' from the Helper Window.  To re-enable the STOP 
  386. Button select 'STOP Button' again.  You (the helper) can exit ToyBox 
  387. from the main window, even if the the STOP Button is disabled, by 
  388. pressing [Alt]-[s]. 
  389.  
  390.  
  391. 15.  Turning Sound On/Off
  392.  
  393. You can turn off all ToyBox sounds by selecting 'Sound' from the Helper 
  394. Window.  You can turn the sounds back on by selecting 'Sound' again.  
  395. This option has no effect on sounds in programs running under ToyBox.
  396.  
  397.  
  398. 16.  Error Messages
  399.  
  400. If you get a "Bad Command or File Name" or "Spawn Error:  No Such File 
  401. or Directory" error message when you try to run a program from ToyBox, 
  402. it means that ToyBox cannot find the program.  Check to ensure that you 
  403. have installed the correct drive, directory, and filename for the 
  404. program.
  405.  
  406. ToyBox keeps a small amount of memory (19k) for itself when it is 
  407. running an installed program.  If the program it is trying to run takes 
  408. all available memory, include the 19k needed by ToyBox, the program may 
  409. crash, or you may get an error message that ToyBox is aborting due to 
  410. lack of memory.  The only solutions to allow you to run that particular 
  411. program from ToyBox are to add more memory, or take out some of the 
  412. memory-resident drivers or TSR's that are using up memory.
  413.  
  414. You will get an error message if you attempt to read from a disk drive 
  415. that is not ready or write to a disk drive that is write-protected.  
  416. After displaying the error message, ToyBox will give you a chance to 
  417. correct the problem and try again.
  418.  
  419.  
  420. 17.  License and Warranty
  421.                
  422. You may use ToyBox on a trial basis.  If you continue to use it after a 
  423. reasonable amount of time, you must send the $15.00 registration fee as 
  424. described in Section 3.  You are free to copy and distribute ToyBox for 
  425. noncommercial use if no fee is charged and it is not modified in any 
  426. way.  Clubs, user groups and disk vendors may charge a nominal fee not 
  427. to exceed $6.00 for expenses and handling while distributing ToyBox.  
  428. Site licenses for schools and other organizations are available.
  429.  
  430. Virtual Magic Software hereby disclaims all warranties relating to this 
  431. software, whether express or implied, including without limitation any 
  432. implied warranties of merchantability or fitness for a particular 
  433. purpose.  We will not be liable for any special, incidental, 
  434. consequential, indirect or similar damages due to loss of data or any 
  435. other reason.  In no event shall our liability for any damages ever 
  436. exceed the price paid for the license to use software, regardless of the 
  437. form of the claim.  The person using the software bears all risk as to 
  438. the quality and performance of the  software.
  439.  
  440.  
  441. 18.  Icon List
  442.  
  443. ToyBox comes with a collection of 72 icon files.  Icon use is
  444. explained in detail in Section 10 of this User's Guide.  For quick 
  445. reference, this list is also included as a separate file (ICONLIST.DOC).
  446.  
  447. DBD.ICN - Dark Blue Diamond         LBD.ICN - Light Blue Diamond
  448. DBS.ICN - Dark Blue Square          LBS.ICN - Light Blue Square
  449. DBT.ICN - Dark Blue Triangle        LBT.ICN - Light Blue Triangle
  450. DCD.ICN - Dark Cyan Diamond         LCD.ICN - Light Cyan Diamond
  451. DCS.ICN - Dark Cyan Square          LCS.ICN - Light Cyan Square
  452. DCT.ICN - Dark Cyan Triangle        LCT.ICN - Light Cyan Triangle
  453. DGD.ICN - Dark Green Diamond        LGD.ICN - Light Green Diamond
  454. DGS.ICN - Dark Green Square         LGS.ICN - Light Green Square
  455. DGT.ICN - Dark Green Triangle       LGT.ICN - Light Green Triangle
  456. DMD.ICN - Dark Magenta Diamond      LMD.ICN - Light Magenta Diamond
  457. DMS.ICN - Dark Magenta Square       LMS.ICN - Light Magenta Square
  458. DMT.ICN - Dark Magenta Triangle     LMT.ICN - Light Magenta Triangle
  459. DRD.ICN - Dark Red Diamond          LRD.ICN - Light Red Diamond
  460. DRS.ICN - Dark Red Square           LRS.ICN - Light Red Square
  461. DRT.ICN - Dark Red Triangle         LRT.ICN - Light Red Triangle
  462. BD.ICN  - Brown Diamond             YD.ICN  - Yellow Diamond
  463. BS.ICN  - Brown Square              YS.ICN  - Yellow Square
  464. BT.ICN  - Brown Triangle            YT.ICN  - Yellow Triangle
  465.  
  466. A.ICN     Letters A-Z               0.ICN     Numbers 0-9
  467. B.ICN                               1.ICN
  468. C.ICN                               2.ICN
  469.   :                                   :
  470. Z.ICN                               9.ICN
  471.  
  472.  
  473.  
  474.